How to install Capella and Addons ?

Capella Installation

Prerequisites Needed for Install

For a successful installation of Capella, your computer must meet the following recommended requirements:

• 64 bit computer running Windows 7/8/10, Windows Server 2008/2012/2016
• An unzip software such as 7Zip or equivalent
• 2 GHz processor
• 4 Go RAM
• 15 GB of available hard disk space

Capella requires a Java Runtime Environment (version 1.8 or later) installed in the computer: Recommended version is JRE 8u121

Capella Installation Procedure

Before starting the installation, the target location of Capella must be cleaned:

1. The previous Capella version must be correctly uninstalled (See related section)
2. All manual patches/extensions must be removed
3. Download Capella and extract it in a given directory

Note : See Restriction

Verification Installation Procedure

The Capella installation is successful if the archive extraction finished without errors.

• The Capella folder should contain two folders:
  • eclipse: the Capella modeling workbench with the .exe of Capella
  • samples: the sample models

Addons Installation

There are 3 ways to install addons :

1. Simple installation
   • Install the addons directly in the dropins folder of Capella :
   1. Unzip the archive of the addon in your Capella "dropins" directory
2. External installation
   • Install the addons in an external directory and configure Capella to get them from this specific directory :
   1. Unzip the archive of the addon in a directory
   2. Add -Dorg.eclipse.equinox.p2.reconciler.dropins.directory=<myAddonsDirectory> at the end of the eclipse.ini file (after -vm)
3. Multiple contexts installation
   • Create several contexts with specific addons and allow users to launch Capella on one or another context :
     1. Create contexts directories (copy eclipse.ini from Capella and unzip the needed addons in a dropins folder).
     2. For each context, change the eclipse.ini file as follows:

• For Context_A, add the following lines at the end of the eclipse.ini file (afer -vm)-(Example)

• For Context_B, add the following lines at the end of the eclipse.ini file (afer -vm)-(Example)

• Create shortcuts to launch Capella using the eclipse.ini file stored in the expected context:
  • For context A: <CAPELLA_INSTALLATION_DIR>\eclipse\eclipse.exe --launcher.ini D:\CapellaContexts\Context_A\eclipse.ini
  • For context B: <CAPELLA_INSTALLATION_DIR>\eclipse\eclipse.exe --launcher.ini D:\CapellaContexts\Context_B\eclipse.ini

The extensions for Capella requires the installation of the following software:

• Capella : For the Capella installation, please refer to this guide

Note:Make sure that the addon/extension is compatible with your current version of Capella.

Addons

The installation procedure is the same for all addons.

As Dropin

To manually install your addon:

• Download the addon as a dropin
• Extract the contents of the downloaded archive into <CAPELLA_INSTALLATION_DIR>/eclipse/dropins directory

Check that the extraction process has finished without error.

• Start Capella

As Update Site

• Download the addon as an update site
• Start Capella
• Open Help using the menu toolbar
• Select Install New Software
• A wizard is displayed
• Click on Add button
• Click on Archive... button
• Select the downloaded addon archive and press OK
• Give it a name and press OK
• Click on Select All button then Next
• Agree and click on Finish
• Restart when prompted

Verification

The following procedure for verifying the successful installation of addons, assumes that Capella is well installed and fully functional.

Plugins Verification

• Start Capella
• Open Help using the menu toolbar
• Select About Capella
• Select Installation Details
• Select Plugins tab
• Scroll down the list

Check that the plugins that correspond to the addon are displayed.

Restriction